home *** CD-ROM | disk | FTP | other *** search
/ BBS in a Box 7 / BBS in a Box - Macintosh - Volume VII (BBS in a Box) (January 1993).iso / Files / Tele / M / MSGAGE 3.0.cpt / Msgage.Doc < prev    next >
Text File  |  1991-01-14  |  8KB  |  150 lines
  1. ABOUT MSGAGE 3.0
  2.  
  3. MSGAGE is a Second Sight command 50/51 external application that will
  4. let you and/or users that you allow to access it to modify your Second
  5. Sight message base.  MSGAGE allows editing of the message headers and
  6. message locations, changing the destination of NetMail (for systems 
  7. using Tabby), and gives you more control over your message base.  If
  8. you're looking for a "Mac-like" interface, MSGAGE is NOT what you're
  9. looking for!  It is designed to be used locally OR remotely and, as
  10. such, utilizes a TTY type interface.
  11.  
  12. I'd like to thank Tom Porter for his help in developing this program.
  13. He suffered through many beta versions and his suggestions resulted in
  14. the addition of many of the features you will find most useful.
  15.  
  16. SETTING UP MSGAGE
  17.  
  18. The Easy Way:
  19. Double-click MSGAGE and hold down the mouse button.  You will be presented
  20. with a dialog box to set up MSGSGE's strings.  Click the "Set" button and
  21. double-click on your BBS application in the GetFile dialog box.  Type in
  22. whatever you've called your launchfile (usually LaunchRRH or LaunchSS), 
  23. tab once and type in the FULL PATHNAME of whatever you want to call the
  24. seperate file that MSGAGE will use to remember who has accessed MSGAGE and
  25. the highest message number they've accessed in MSGAGE.
  26.  
  27. The "High Tech" Way:
  28. If you prefer, you can use ResEdit or equivalent, open the MSGAGE application
  29. and set the following "STR " resources for your system:
  30.  
  31.      STR 2000: Pathname to Second Sight. This must be the full pathname
  32.                and must end in a colon!
  33.      STR 2001: Second Sight Name.  What you've actually named the 
  34.                Second Sight application on your drive.  Probably
  35.                "Second Sight" or "Red Ryder Host".
  36.      STR 2002: Launch File name.  The name you've assigned for the Launch
  37.                file created by Second Sight when a Command 50/51 is used.
  38.                Probably "LaunchSS" or "LaunchRRH".
  39.      STR 2003: Full pathname to SysOp Record.  MSGAGE keeps track of who
  40.                has used the program and the last message number they have
  41.                read in a seperate file.  Enter the full pathname that you
  42.                want this data saved in.
  43.  
  44. Finally:
  45. Once the string resources have been assigned, place MSGAGE in the same
  46. folder as Second Sight and place a Command 50/51 menu command(s) to
  47. MSGAGE in the menu(s) from which you would like to access it.
  48.  
  49. INFORMATION
  50.  
  51. The default parameters when you first enter MSGAGE are set to find all
  52. messages reading forward from the last message you accessed with MSGAGE.
  53. You can change any parameter, but it's up to you to not make a search
  54. impossible.  Nothing bad will happen if you should do that, but MSGAGE
  55. won't find any messages.  For example, if you search for "Public 
  56. messages only" in a private message section, MSGAGE will find all the
  57. messages that meet those parameters--none.
  58.  
  59. MSGAGE will only allow a user with an access level of 255 to modify the 
  60. Public/Private parameter.  Otherwise it is defaulted to "Public Only".
  61.  
  62. The "To", "From", and "Subject" search strings in MSGAGE are used to
  63. search for the appropriate field(s) CONTAINING the entered string(s).
  64. That is, if you search for messages to "Bob", MSGAGE will find any
  65. message to a name containing the "BOB" letter combination such as
  66. Bob Adams, Ed Abbobowicz, Bobbie Sheffield, etc.  Searches are not
  67. case sensitive.
  68.  
  69. In the case of "To" and "From" searches, if strings are entered for
  70. both fields, MSGAGE will ask if you want to find messages addressed
  71. to AND from those fields or to OR from them.  In other words, if you
  72. search for messages to "Bob" and from "Ray", you have the option of
  73. finding messages where BOTH are true or EITHER is true.
  74.  
  75. Entering a string in the "[V]ia Node" option will limit found messages
  76. to those originating from a node number containing the entered string.
  77. That is, if you enter "2", any message from a node number containing
  78. a 2 (204/555, 102/8, etc) will be found.  The more you enter, the more
  79. restrictive the search will be.  Entering a node search string will force
  80. the local/imported origin search parameter to "imported" since locally
  81. originated messages won't carry a node number.
  82.  
  83. "Save last message number" will record the last message number you
  84. accessed with MSGAGE.  This will make it easier to pick up where you
  85. left off the next time you use MSGAGE.
  86.  
  87. Any of the M>essage Flags can be toggled.  Most are self-explanatory,
  88. but the last two--Local/Imported and Export/No Export--may need
  89. some explanation to use them.  If you want to re-export a message to
  90. the network, it must be flagged as LOCAL and NO EXPORT.  I haven't 
  91. tried this with Mike Lininger's Export, but Pete Johnson's TExport
  92. (v. 1.91) won't export a message unless it is of local origin AND has
  93. not been exported.
  94.  
  95. The A>rchive command will write the current message to a text file.
  96. You are given the option to write to the default file "Msgage Archive",
  97. to an exiting text file, or to create a new text file.  If you use one
  98. of the latter two options, that file becomes the default file for the
  99. balance of the current session.  The archived message file can be
  100. read/printed/edited later with any text editor DA or application.
  101. Extremely long messages can take a while to read in and save.
  102.  
  103. The C>opy command will allow a message to be forwarded to another user.
  104. This should be useful if you need to pass a private message to another
  105. user or from one echo to another.  You will be asked for the message
  106. section and user to which it is to be forwarded, and the node number
  107. if you forward it into a NetMail section.  This generates a new message
  108. leaving the original in its current state.
  109.  
  110. The G>et Replies command will find any replies to the CURRENT message only.
  111. That is, messages which are a reply to the current message number.  Replies
  112. to replies are NOT found.
  113.  
  114. MSGAGE accesses Second Sight's "Userlog", "MESSAGES", "MSGHDR", "MSGTXT",
  115. "CONFIG" and "Launch__" files.  It only writes to the "MSGHDR" file.
  116. While I have never experienced any corruption of any file, it never hurts
  117. to have a backup "just in case."
  118.  
  119. LEGAL STUFF
  120.  
  121. The programmer and any distributor of this software is not liable for any
  122. loss of data or failure of this software to function as described.  This
  123. software is Copyrighted by the author, Ray Leninger, but there is no charge
  124. for the use of this software. Any distributor who makes ANY charge, including
  125. but not limited to reproduction charges, postage and handling fees, disk
  126. charges, and/or membership fees, for the distribution of software is
  127. specifically prohibited from distributing this software. Commercial and
  128. private bulletin board systems which charge an access fee are NOT excluded
  129. by this prohibition.  Distribution of this software without this documentation
  130. will be considered a violation of the author's copyright.
  131.       Copyright © 1987-1991 Ray Leninger.  All rights reserved.
  132.  
  133. KNOWN BUGS
  134.  
  135. MSGAGE is known to bomb (with magical screen display and sound) after the
  136. processing of a mail bundle by Tabby IF you have SuperClock installed.  I
  137. don't have a fix for this, but I do thank Jesse Tharin for is diligent work
  138. in isolating the cause.  Soooo...if you want to use MSGAGE and use Tabby, it
  139. would be wise to remove SuperClock.
  140.  
  141. ABOUT ME
  142.  
  143. Ray Leninger                        MacHaven BBS 601-992-9459
  144. 301 Shenandoah Rd.                  GEnie: R.LENINGER
  145. Brandon, MS 39042                   FidoNet: 1:361/106
  146.  
  147. If you have questions or problems or find any bugs in MSGAGE, you can
  148. contact me at any of the above "addresses".  Please don't call me on
  149. my voice telephone line though!  Thanks!  I hope you find this useful!
  150.